home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / text / misc / mpage.lha / mpage / mpage.readme < prev    next >
Encoding:
Text File  |  1999-07-25  |  6.4 KB  |  175 lines
  1. Short:    mpage 2.5 (68k+PPC)
  2. Author:   Mark Hahn, Andreas Kleinert (port)
  3. Uploader: info@ar-kleinert.de
  4. Type:     text/misc
  5.  
  6.  Amiga 68k/PPC port of Mpage.
  7.  
  8.  Mpage is a program to reduce and print multiple pages of text per
  9.  sheet on a PostScript compatible printer.
  10.  It also has limited functionality to do the same with postscript files itself.
  11.  
  12.  The PPC binaries have the ".elf" extension and are useable
  13.  from Shell when being used with ppc.library V46+ or
  14.  Frank Wille's emulation for WOS (V0.6b or higher).
  15.  
  16.  Have fun.
  17.  
  18.  Usage (for example):
  19.  
  20.    MPage TESTFILE >prt:
  21.    MPage TESTFILE >T:DESTFILE
  22.  
  23.  --
  24.  ARK, 25/Jul/99
  25.  
  26.  *************************************************************
  27.  
  28. COPYRIGHT:
  29.  
  30. Mpage and all the files distributed with mpage are covered by copyright:
  31.  
  32.  Copyright (c) 1994-1997 Marcel J.E. Mol, The Netherlands
  33.  Copyright (c) 1988 Mark P. Hahn, Herndon, Virginia
  34.  
  35.      Permission is granted to anyone to make or distribute verbatim
  36.      copies of this document as received, in any medium, provided
  37.      that this copyright notice is preserved, and that the
  38.      distributor grants the recipient permission for further
  39.      redistribution as permitted by this notice.
  40.  
  41. Mpage was written by:
  42.    ...!uunet!\                       Mark Hahn, Sr Systems Engineer
  43.               >pyrdc!mark            Pyramid Technology Corporation
  44.  ...!pyramid!/                       Vienna, Va    (703)848-2050
  45.  
  46.  marcel@mesa.nl
  47.    MESA Consulting  B.V.
  48.    Voorburg
  49.    The Netherlands
  50.    Phone: +31-(0)15-3105252
  51.    Mobile:+31-(0)6-54724868
  52.    Fax:   +31-(0)70-3873683
  53.  
  54. =================================================================
  55. DESCRIPTION:
  56.  
  57. Mpage is a program to reduce and print multiple pages of text per
  58. sheet on a PostScript compatible printer.
  59. It also has limited functionality to do the same with postscript files itself.
  60.  
  61. The following are the files you should have for mpage.
  62.  
  63.      README                 Notes and descriptions, this file
  64.      README.OS2             OS/2 port description
  65.      Copyright              Copyright notice
  66.      CHANGES                Change storys
  67.      Makefile               The Makefile
  68.      TODO                   Wish List for changes
  69.      FAQ                    Useful tips and hints
  70.      NEWS                   Global changes, User visible changes
  71.      Mpage.lsm              LSM file for mpage
  72.      args.c                 Command line and options processing
  73.      encoding.h             Definition of internal default character encoding
  74.      file.c                 Generic file handeling
  75.      glob.c                 Global variable setup
  76.      mpage.h                Definitions
  77.      mpage.c                Main Control
  78.      page.c                 Page layout routines
  79.      post.c                 PostScript file processing
  80.      sample.c               Prints sample page layout pages
  81.      text.c                 Text file processing
  82.      mpage.1                Manual page
  83.  
  84.      fix                    Fix to mpage that makes it work with ArborText
  85.      All.chars              Test file containing all ascii characters
  86.      Encodings              Directory with character encoding library files
  87.      Characters             List of postscript character encoding names
  88.      Encoding.format        Description on how to create character encoding
  89.                             library files
  90.      gencodes.c             Util program to build All.chars file
  91.      Test                   Directory with test pages
  92.  
  93.      OS2                    Contrib to build and use mpage on OS/2
  94.      Contrib                Directory with contributions by others
  95.  
  96.  
  97. INSTRUCTIONS:
  98.  
  99. All you should need to do is run make.
  100. This will create mpage and a program called msample.  Mpage is
  101. the program to print n-up pages.  Msample prints a sample outline.  I
  102. used it for debugging the placement of the layout.  It is also handy
  103. for other layout purposes.  It accepts all the arguments that mpage
  104. does, but does not print files.
  105.  
  106. As a quick sample try:
  107.  
  108.         "mpage  mp_args.c"
  109. or
  110.         "mpage -8 mp_post.c"
  111. or
  112.         "groff  -man mpage.1 | mpage -2"
  113.  
  114.  
  115. The manual page, mpage.1, formats with UCB or ATT manual macros.
  116.  
  117.  
  118.  
  119. USING MPAGE:
  120.  
  121. You will find that it takes a while on an Apple LW or Apple LW+ to
  122. print 4 pages per sheet, It takes "a good long time" for 8 pages.
  123. Reduced PostScript documents take a while too.  (A rule of thumb might
  124. be 4 times as long for 4-pages-per-sheet reduction :-) On a QMS 8ppm
  125. printer 4 pages per sheet is about the same speed and other forms of
  126. "1-up" output.  mpage prints some timing information back from the
  127. printer so you can measure the time required for full jobs.
  128.  
  129.  
  130.  
  131. ADMINISTRATORS:
  132.  
  133. As a printer administrator you should see the wish list for caveats
  134. and information about future versions.  I still have work to do to
  135. make mpage more "administrator friendly", but figured that I'd better
  136. get what's been done out the door.
  137.  
  138.  
  139.  
  140. BUG REPORTS:
  141.  
  142. Mpage is supported but this is done is pare time. So please sent in
  143. bug reports, request or other things related to mpage and once in
  144. a while I'll release a version...
  145. If you have a problem please send me a complete description of the
  146. symptoms.  Please include the brand name of your printer, a copy of
  147. the input file (especially if it is with PostScript input), and a
  148. description of what to look for on the output.  If your printer has an
  149. error log, please include as much of it as is revalant.  In general,
  150. the more clearly organized information I have, the easier it will be
  151. for me. And please do not forget to mention the mpage version you're
  152. using. Also the ouput generated by your mpage might come in handy...
  153.  
  154.  
  155.  
  156. MAKING CHANGES:
  157.  
  158. Please, if you make any improvements, send them back to me so that I
  159. can include them in future versions.  Also I would solicit comments as
  160. to the usefulness, and effectiveness of mpage.  Let me know what you
  161. like or dislike and feel free to ask any questions you have concerning
  162. this mpage distribution.  Thank you!
  163.  
  164. -Marcel Mol
  165. ------------------------------------------------------------------------------
  166. Marcel J.E. Mol               phone: (+31) 015-3105252
  167. ------------------------------------------------------------------------------
  168. Delft University of Technology     | MESA Consulting BV
  169. Netherlands                        | Networking and Unix Consultancy
  170. marcel@duteca.et.tudelft.nl        | marcel@mesa.nl
  171. ------------------------------------------------------------------------------
  172.  They couldn't think of a number, so they gave me a name!
  173.                                 -- Rupert Hine
  174.  
  175.